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CP/M on Helios Disk User Notes 


INTRODUCTION TO THESE NOTES 


This set of CP/M on Helios Disk Users Notes is intended to be 
used as supplementary material to the Digital Research manuals which 
accompany the system. 


It is not at all intended to serve as a stand alone guide to 
CP/M, but is aimed at assisting the new system owner in bringing the 
system up on their equipment as soon as possible. It is also aimed at 
informing the more experienced users about certain of the internal 
"hooks” and options available which are specific to this particular 
CP/M system. 


The Users Notes are divided into the following sections: 


STARTING OUT 
PROGRAMS PROVIDED 
SYSTEM LAYOUT 

HOW TO BOOT UP A STANDARD SOL SYSTEM 
HOW TO BOOT UP A NON-SOL SYSTEM 
CHANGING THE I/O CONFIGURATION 
MODE OPTIONS 

APPENDIX - Sample User Area Listing 

STARTING OUT 


Upon receiving your CP/M on Helios Disk package of diskette and 
manuals, the first actions to take are: 

1) Complete and return the Registration Card 2) Read the 
manuals 3) Back-up the diskette 

Your CP/M on Helios is a serial numbered system licensed for 
your use. Unless the Registration Card is received by Lifeboat 
Associates, as is required under' the terms of the license, no 
assistance can be offered with respect to queries you may wish 
answered. Remember that you are acquiring a complex and advanced 
piece of software which is under constant review and improvement both 
at Lifeboat Associates and Digital Research. We most strongly advise 
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you to take advantage of the fact that this is a current and evolving 
system, and that you ensure that you are firmly plugged into the 
system for disseminating news and updates about CP/M. 

Initially, at the minimum, read the Digital Research manual "An 
Introduction to CP/M Features and Facilities" in addition to this 
"CP/M on Helios Disk Users Notes". Thorough reading of these will 
make the process of bringing up the system much smoother. For further 
details, the user should also refer to the manuals "CP/M Interface 
Guide" and "CP/M System Alteration Guide". 

We most strongly advise that your first act, when your system 
is running, is to format a blank disk and copy the distribution 
diskette. Do not EVER write on your distribution diskette. Put it 
away in a safe place. It will provide a last resort back-uo, 
regardless of what happens later, in the event of hardware or 
software malfunction. 


PROGRAMS PROVIDED 


These are the programs supplied on your disk: 


MOVCPM.COM 

ASM.COM 

DDT.COM 

DUMP.COM 

ED.COM 

L0AD.COM 

PIP.COM 

STAT.COM 

SUBMIT.COM 

SYSGEN.COM 

DUMP.ASM 

USER.ASM 

F0RMAT.COM 

C0PY.COM 

SAVEUSER.COM 


- System relocator 
-Assembler 
-Debugger/Monitor 
-Disk hex dump 
-Editor 

-Hex file loader 
-Perlpherial interchanger 
-File and iobyt paramaters 
-Batch processor 
-System read/write 
-Sample .ASM program 
-Sol I/O listing 
-Blank disk formatter 
-Diskcopy program 
-Patch saver for i/o 


SYSTEM LAYOUT 


The CP/M system you have received is designed to run in 32K of 
memory. In order to conform with the memory conventions used in the 
Digital Research manuals however, we refer to this system as a 
"nomimal" 30K system. 

You will find more information on the memory usage of CP/M in 
the Alteration Guide. In general, when references are made to a 16K 
system with bias "b", the correct bias "b" to be used is 38 OO hex. 
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The following table will list the locations of various CP/M 
molules in both the distribution 30K system and the "sysgen image'*. 
The "sysgen image" is the location of the CP/M system in memory when 
SYSGEN is run. This position is the most useful for oatching the 
system- 


Module 

30Ksystem 

Sysgen 

BOOT 

0 hex 

900 hex 

TPA 

100 

not appi 

CCP 

6100 

OAOO 

BDOS 

6900 

1100 

BIOS 

7600 

1F00 

MODEBYTE 

7BFF 

24FF 

USER 

7C00 

2500 

BUFFERS 

7E00 

not appl 


HOvJ TO BOOT A STANDARD SOL SYSTEM 


The system as supplied on your disk is designed to run directly 
on a Sol-20 system using Solos. You must have at least 32K of 
read/write memory starting at location 0. In addition, it is best if 
you have installed the personality module containing the Helios boot 
prom containing the "BO" command. If you are running your Helios 
under PTDOS, you probably already have the correct prom. If not, 
refer to the Helios manual for a listing of a suitable boot program. 

If you have satisfied the memory requirements above and have the 
correct prom (or program), simply insert the CP/M disk in drive 0 and 
type "BO". Your system should come up with the sign-on message: 

CP/M on Helios Disk 
30K Version 1 . 4018 

Copyright (C) 1979 Lifeboat Associates 
A> 

Congratulations, your system is on the air. The first thing you 
must do is put a blank disk in drive 1 (B: in CP/M convention) and 
run first the format program by typing F0RMAT<cr> and then the copy 
program by typing COPY and using the "M" option. Then put your 
original disk in a safe place until (hopefully never) needed. It is 
very important that you NEVER write on the original distribution 
diskette so you are always sure to have a back-up. Use the disk you 
just created for normal work and make additional cooies of it as 
needed. Remember to put the proper copyright notices on any disk you 
make as required by Digital Research. 
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HON TO BOOT IN A NON-SOL SYSTEM 


If you have a non-Sol system, use whatever procedure you 
normally use to bring up PTDOS to boot in the CP/M diskette in drive 
0 (CP/M convention drive A:). If you have never used PTDOS, refer to 
the program listing in your Helios manual and use your monitor or 
other facilities to put this program in memory. Then run that 
bootstrap program with your CP/M diskette in drive 0. The system will 
NOT sign on. Instead it will come to a stop without any console 
message. 

At this point, the system is properly in memory and is ready to 
be patched with your individual console i/o. In appendix A you will 
find a listing of a sample user area. Although this will not apply 
exactly to your case, it will serve as a guide for you to patch the 
system for your needs. The important thing in the beginning is to 
patch at least the jumps for CINIT, WINIT, CONIN and CONOUT. The 
other jumps can be terminated with simple returns until you wish to 
further patch your system. 

The simplist way to bring up your system after booting is to 
use your monitor or other facility to patch the user area until you 
think you have usable console functions Then, try them out by jumping 
to memory location 7600 hex. The system will call your CINIT routine 
and then (hopefully) sign-on. If it does, go thru the routine of 
formatting a new disk and copying your distribution diskette as 
outlined elsewhere. Then, with the COPY (not the original, please) in 
drive 0. run the SAVEUSER program which will write your patched user 
area onto your disk. From this time on, you should be able to boot in 
that disk and get a sign-on message, thus allowing you to use the 
facilities of the CP/M system to improve your user area. 


PATCHING YOUR I/O 


If you have a Sol system, the file USER. ASM on your disk is an 
exact copy of the i/o contained in your user area. Changes may be 
made in this file to suit your own purposes and then implemented in 
your system. If you wish to make simple patches, we have included a 
file called SAVEUSER. When SAVEUSER is run, it will write onto your 
drive A: disk the patched user area and mode byte so that when you 
boot up in the future, these changes will be in your system. 


CHANGING YOUR I/O CONIGURATION 


Your Sol user area is fully configured to use all four of the 
Sol pseudo-ports through manipulation of the lOBYT at memory location 
3. Refer to page 15-16 of of the Alteration Guide for a explanation 
of the iobyt and pages 14-16 of the Introduction to Features and 
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Facilities for a description of how to manipulate the iobyt using the 
STAT program- The initial boot up configuration of the iobyt may be 
changed at location 7C18 hex in the user area. As shipped, that byte 
is set for: 


Console equal 
Reader equal 
Punch equal 
List equal 


pseudo-port 1 
pseudo-port 2 
pseudo-port 2 
pseudo-port 3 


Sol keyboard/video 
Sol serial inport 
Sol serial outport 
Sol parallel port 


These device assignments may be dynamically changed in the 
running system by the use of the STAT program. In particular, if you 
wish to run your printer on the serial port instead of the parallel 
port you would type the command: 

STAT LST:=CRT: 

Many other re-assignments are possible and some time spent getting 
familiar with the uses of STAT will pay off. 


MODE OPTIONS , . 

Your disk contains a mode byte which is located atyTBFFj hex in 
your standard 30K system ( or 24FF hex in the sysgetrTmage) Its 
purpose is to allow you to enable or disable the read after write 
function and also to allow you to use the AUTO function. 


Your disk has been shipped with read after write enabled. This 
slows down disk writing by a factor of 3 but gives a certain safety 
element that we think is important. If you have confidence in your 
system and wish to disable this function, set bit 6 of the mode byte 
to 0. That is, change the mode byte which is 40 hex as shipped to 0 
to disable read after write- Running SAVEUSER will permanently save 
mode byte changes on your system disk. 

Your disk has been shipped with the AUTO function disabled. 
This function may be used in the following way. If it is set. when 
CP/M does a boot, the system will look for a file called AUTO. COM on 
drive A: , and will run it at that time if found. No harm can be done 

if the file is not in the directory, CP/M will simply report that it 

could not find a file called AUTO. This function could be used. for 
example, to automatically run BASIC when the system is started up, by 
simply re-naming BASIC. COM to AUTO. COM and setting the mode byte to 
do AUTO on cold boots. Its very handy and available whenever you want 
it. To implement the AUTO function on cold boots, set bit 0 of the 
mode byte to 1. To implement it on warm boots, set bit 1 of the mode 

byte to 1. Set both bits if you want it on both cold and warm boots. 
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APPENDIX - SAMPLE USER AREA LISTING FOR 2SI0 



USER AREA FOR 2SI0 BOARD 


001E = 
7C00 = 


0003 = 
0002 = 
0002 = 
0001 = 

7C00 



7C00 C3197C 
7C03 C32A7C 
7C06 C32B7C 
7C09 C3347C 
7C0C C3407C 
7C0F C3407C 
7C12 C3407C 
7015 C3347C 
7C18 94 


7C19 3E27 
7C1B D303 

7C1D 3E40 
7C1F D303 


7C21 3ECE 
7C23 D303 
7C25 3E27 
7C27 D303 
7C29 C9 


EQUATES 


MSIZE 

EQU 

30 

;CP/M VERSION MEMORY SIZE IN 

USER 

EQU 

MSIZE*1024+400H ;START OF USER AREA 

;2SI0 

STATUS 

EQUATES 

EQU 

3 

;2SI0 STATUS PORT 

DATA 

EQU 

2 

;2SI0 DATA PORT 

RDA 

EQU 

2 

;INPUT DATA AVAILABLE 

TBE 

EQU 

1 

;READY FOR OUTPUT 

> 

ORG 

USER 

;LOC AT 7C00H IN DIST SYSTEM 

; JUMP 

TABLE - 

JMPS MUST 

REMAIN HERE. IN SAME ORDER 

CINIT 

JMP 

CINITR 

;COLD INITIALIZATION 

WINIT 

JMP 

WINITR 

;WARM INITIALIZATION 

CONST 

JMP 

SIOST 

;CONSOLE STATUS 

CONIN 

JMP 

SIOIN 

;CONSOLE INPUT 

CONOUT 

JMP 

SIOUT 

;CONSOLE OUTPUT 

LIST 

JMP 

SIOUT 

;LIST OUTPUT 

PUNCH 

JMP 

SIOUT 

;PUNCH OUTPUT 

READER 

JMP 

SIOIN 

;READER INPUT 


lOSET ;INITIAL MODE BYTE SETTING 

NOTE: MODE BYTE NOT IMPLEMENTED IN THIS USER AREA 
BUT THIS IS A GOOD PLACE TO STORE IT. 

CP/M TRANSFERS THIS TO LOACATION 3 ON COLD BOOT 
IT MAY THEN BE CHANGED DYNAMICALLY BY STAT 

;INITIALIZE 2SIO BOARD ON COLD BOOT AND RESET 
CINITR MVI A,27H ;DUMMY INSTRUCTION 

OUT STATUS 

;ENABLE MODE INSTRUCTION FORMAT 
MVI A,40H 
OUT STATUS 

;SET 2 STOP BITS, DISABLE PARITY, 8 BIT WORD 

;CL0CK=16X BAUD RATE 

MVI A,0CEH 

OUT STATUS 

MVI A,27H 

OUT STATUS 

RET 


7C2A C9 



7C2B DB03 
7C2D E602 
7C2F 3E00 
7C31 C8 


WINITR RET ;NO INIT NEEDED ON WARM BOOT 

•CONSOLE STATUS. RET OFFH IF CHAR READY, 0 IF NONE 
SIOST IN STATUS 
ANI RDA 
MVI A,0 

HZ ;0 IF NO KEY 
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7C32 2F 
7033 C9 


7C34 DB03 
7C36 E602 
7C38 CA347C 
7C3B DB02 
7C3D E67F 
7C3F C9 


7C40 DB03 
7C42 E601 
7C44 CA407C 
7C47 79 
7C48 D302 
7C4A C9 


CMA ;0FFH IF KEY 

RET 

•CONSOLE INPUT CHAR TO REGISTER A 
SIOIN IN STATUS 
ANI RDA 
JZ SIOIN 
IN DATA 

ANI 7FH ;STRIP PARITY 
RET 

•CONSOLE OUTPUT CHAR FROM REGISTER C 
SIOUT IN STATUS 
ANI TBE 
JZ SIOUT 
MOV A,C 
OUT DATA 
RET 
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The program listing shown below contains a "patch" to the CP/M 1.4 standard 
assembler, ASM. To instaU this patch, first create the patch program (called 
ASMPATl.ASM below) using ED, and assemble using ASM. Ensure that the listing 
produced by the assembly matches the listing shown below. 

-ASM PATCH OF 1/8/79 

THIS PATCH FIXES AN ERROR WHICH OCCURS IN STATEMENTS 
INVOLVING STRING CONSTANTS WHICH INCLUDE LOWER CASE. 
PREVIOUSLY, ALL LOWER CASE CHARACTERS WERE TRANSLATED 
TO UPPER CASE AUTOMATICALLY - AFTER MAKING THIS 
PATCH, ASM WILL NOT PERFORM CHARACTER TRANSLATION 
WITHIN STRING CONSTANTS. 

;CURRENT SCANNER TOKEN 
;STRING CONSTANT TOKEN 
;SUBROUTINE TO TRANSLATE CASE 
;LOCATION OF PATCHED CODE 
;LOCATION OF FREE AREA 

.•REPLACES "CALL TRANS" 


I PATCH AREA 


o 


0185 

= 

TOKEN 

EQU 

0185H 

0003 

= 

STRNG 

EQU 

0 3H 

119E 

= 

TRANS 

EQU 

119EH 

HAD 

= 

GNCN 

EQU 

llADH 

13 2D 

— 

PATCH 

EQU 

132DH 

1133 


? 

ORG 

GNCN+6 

11B3 

C32D13 


JMP 

PATCH 

132D 


7 

ORG 

PATCH 

132D 

3A8501 


LDA 

TOKEN 

1330 

FE03 


CPI 

STRNG 

1332 

C49E11 


CNZ 

TRANS 

1335 

C9 


RET 


1336 



END 



?TRANSLATE IF NOT STRING 


• 'r' 


. 

Include this patch in the machine code image for ASM using DDT by first loading 
ASM.COM into memory, then overlaying the memory image with the patch file, as 
follows; 


A>DDT ASM.COM 
DDT VERS 1.4 
N EXT PC 
2100 0100 
-lASMPATl.HEX 
-R 

N EXT PC 
2100 0000 
-G0 

A>SAVE 32 ASMX.COM 


Test the new ASMX.COM file by entering a simple program which includes a string 
containing both upper and lower case characters. The single line program shown below 
will suffice: 


DB 'AaBbCc’ 


When you are assured that your patch was installed correctly, save a copy of ASM.COM 
for archive purposes, erase ASM.COM, and rename ASMX.COM to ASM.COM. 




